创建充值 Refund 对象

通过发起一次充值退款请求创建一个新的 refund 对象,只能对已经充值成功的 recharge 对象发起全额退款。当退款成功后,会发送 Webhooks 通知。

请求参数描述
APP_ID required string对应 app 对象的 id,该参数仅需要填写在请求地址内,查看 如何获取App ID
RECHARGE_ID required stringrecharge 对象的 id,该参数仅需要填写在请求地址内。
description required string退款详情,最多 255 个 Unicode 字符。针对 cmb_wallet & cmb_pc_qr 渠道最多支持 99 字节;针对 jdpay_wap 渠道最多支持 128 字节;针对 paypal 渠道最多支持 30 字节;针对 coolcredit 渠道最多支持 100 Unicode 字符。
funding_source optional string微信及 QQ 类退款资金来源。取值范围:unsettled_funds:使用未结算资金退款;recharge_funds:微信-使用可用余额退款,QQ-使用可用现金账户资金退款。注:默认值 unsettled_funds,该参数对于微信渠道的退款来说仅适用于微信老资金流商户使用,包括 wxwx_pubwx_pub_qrwx_litewx_wapwx_pub_scan 六个渠道;新资金流退款资金默认从基本账户中扣除。该参数仅在请求退款,传入该字段时返回。
metadata optional hash详见 元数据

返回

返回一个 refund 对象,或者返回一个错误,详见 错误

定义

POST https://api.pingxx.com/v1/apps/{APP_ID}/recharges/{RECHARGE_ID}/refunds
待补充
待补充
待补充
待补充
待补充
待补充
待补充

请求示例

curl https://api.pingxx.com/v1/apps/app_1Gqj58ynP0mHeX1q/recharges/2001706060000002372/refunds \
-H "Pingplusplus-Signature: {SIGNATURE}" \
-H "Pingplusplus-Request-Timestamp: 1496728534" \
-u sk_test_ibbTe5jLGCi5rzfH4OqPW9KC: \
-d {
    "description": "reharge refunds"
}
待补充
待补充
待补充
待补充
待补充
待补充
待补充

返回示例

{
  "id": "re_vXr14Se1GOGKyjzj5KPKizv9",
  "object": "refund",
  "order_no": "20161000167",
  "amount": 10000,
  "created": 1496743652,
  "succeed": false,
  "status": "pending",
  "time_succeed": null,
  "description": "reharge refunds",
  "failure_code": null,
  "failure_msg": null,
  "metadata": {},
  "charge": "ch_SejbHOrzbjvPunjHmD08SCi9",
  "charge_order_no": "20161000167",
  "transaction_no": null,
  "extra": {}
}